home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 1.iso / util / pfe0601.zip / README.TXT < prev   
Text File  |  1995-03-24  |  15KB  |  373 lines
  1.                           Programmer's File Editor
  2.                           ------------------------
  3.  
  4. Welcome to Programmer's File Editor. This file is the place to start looking at
  5. the program: if you've not seen PFE before there's a synopsis of its main
  6. features; and if you've used earlier versions there's some essential
  7. information on major changes.
  8.  
  9. Below you'll find
  10.  
  11.     1. ABSTRACT
  12.         A brief list of PFE's main features
  13.     2. USING AND DISTRIBUTING PFE
  14.         The terms on which you can use it and pass it on
  15.     3. CONTACTING THE AUTHOR
  16.         How to pass on your criticisms, suggestions, bug reports
  17.         and maybe even praise
  18.     4. WHERE TO GET PFE
  19.         Places to look for PFE on the Internet and elsewhere
  20.     5. UPGRADING FROM 0.05.007 AND EARLIER
  21.         Important information if you're currently using the previous
  22.         release
  23.     6. OTHER FILES YOU SHOULD LOOK AT
  24.         The other important text files in this release
  25.     7. THE FILES YOU SHOULD GET
  26.         What should be in your distribution set
  27.     8. INSTALLING PFE
  28.         How to install everything
  29.     9. WHICH VERSION SHOULD YOU USE?
  30.         How to pick the most appropriate version
  31.  
  32. ---
  33.  
  34. Alan Phillips     ( A.Phillips@lancaster.ac.uk )
  35. March 1995
  36.  
  37.  
  38. -------------------------------------------------------------------------------
  39.  
  40.  
  41. 1. ABSTRACT
  42. -----------
  43.  
  44. This is the 0.06.001 release of Programmer's File Editor, a large-capacity
  45. multi-file programming oriented editor for Windows 3.1x, Windows NT on Intel
  46. and PowerPC platforms, and Windows 95
  47.  
  48. PFE includes the following features:
  49.  
  50. - The size of file it can handle is limited only by the total amount of
  51.   virtual memory available
  52. - No arbitrary limit on the number of lines a file can contain
  53. - It can edit multiple files, the number being limited only by the
  54.   available system resources
  55. - Accepts files dropped from File Manager or other drag-drop server
  56. - Allows multiple edit windows showing the same file
  57. - Multi-level undo facility
  58. - Can read and write files in UNIX format using LF as line terminator, with
  59.   automatic format detection
  60. - Can run multiple instances if desired
  61. - Backup copies can be maintained of existing files when saving
  62. - Most-recently-used list of files allows easy selection between sessions
  63. - Line numbers can be shown in any edit window if required
  64. - Any installed fixed-pitch screen font, including TrueType, can be used in
  65.   edit windows
  66. - The most frequent operations can be performed from active buttons on a 
  67.   tear-off toolbar
  68. - Active status bar reports settings and allows easy alteration of common ones
  69. - Text can be copied and moved by dragging and dropping
  70. - Tabs can be inserted as TAB characters or spaces
  71. - DOS commands, such as compilers, can be run with the output captured
  72.   in an edit window
  73. - An application being developed can be quickly launched from a configurable
  74.   dialog
  75. - Commonly-used text can be inserted in a simple operation from template
  76.   libraries
  77. - Fully-remappable keyboard, including two-key operation similar to MicroEMACS
  78.   and mapping of Alt keys to functions
  79. - Multiple sets of key mappings can be stored, and selected as required from
  80.   a dialog or from the command line
  81. - Keystrokes and menu commands can be recorded in a replayable keyboard macro
  82. - Commonly-used program development tools can be configured into a list
  83.   and started simply from a dialog
  84. - Files can be printed either in total, by line range, or selected text only
  85. - Automatic line indenting and removal of trailing spaces
  86. - Automatic configuration of edit options depending on file type
  87. - Automatic configuration of tab sizes depending on file type
  88. - Automatic brace alignment when editing C source
  89. - Text indent/undent operations
  90. - Optional automatic text wrapping at configurable margin
  91. - Can mail files to MAPI-compliant mailers like Microsoft Mail
  92. - User-configurable help menu
  93. - Comprehensive help file with help buttons on all dialogs and F1 help
  94.   available for system messages
  95. - Mouse help available on screen and menu items
  96. - Double click on right button starts help engine for help on keywords
  97.   in edit windows
  98. - Allows Windows to be closed down and the system rebooted from the system menu
  99. - Uses standard MDI methods to be fully compatible with other Windows apps
  100. - All operations are TWI compliant
  101. - Windows can be tiled vertically to maximize width
  102. - Window text, window background, workspace, toolbar and status bar colours
  103.   fully configurable
  104.  
  105. Additionally, the editor can be controlled by another application across a
  106. DDE client-server link.
  107.  
  108.  
  109. 2. USING AND DISTRIBUTING PFE
  110. -----------------------------
  111.  
  112. PFE may be used in any way, for any purpose, at no cost. In may be distributed
  113. by any means, provided that the original files as supplied by the author remain
  114. intact and no charge is made other than for reasonable distribution costs.
  115.  
  116. You do not need to register to use PFE or buy a licence.
  117.  
  118. PFE may be placed on any archive or BBS system
  119.  
  120. PFE may not be distributed as an essential component of any commercial product
  121. without a prior license agreement with the author
  122.  
  123.  
  124.  
  125. 3. CONTACTING THE AUTHOR
  126. ------------------------
  127.  
  128. I would very much appreciate hearing from you if you use PFE and find problems,
  129. or if you can think of ways it could be improved - and even (or is that
  130. 'especially'?) if you just think it's great. Even if the facility you would
  131. like to see appears to be of interest only to you, tell me about it - you'd be
  132. surprised how many ideas in that class have a much wider appeal.
  133.  
  134. You can contact me by e-mail at
  135.  
  136.     A.Phillips@lancaster.ac.uk
  137.  
  138. I will try to reply to all the mail I receive, but it may take a week or so if
  139. I'm very busy.
  140.  
  141. Please DON'T mail me on CompuServe - you may find an account there with my name
  142. on it, but it's owned by my employers and I don't visit it often. I don't
  143. respond to mail I find there not related to work, sorry. If YOU are on
  144. CompuServe it's easy to mail me on the Internet - just address the mail to
  145.  
  146.     >internet:A.Phillips@lancaster.ac.uk
  147.  
  148. However, this may cost you a little more than mail to other CompuServe users
  149.  
  150.  
  151. 4. WHERE TO GET PFE
  152. -------------------
  153.  
  154. PFE is distributed in three ZIP files. The names they have when they
  155. leave me are
  156.  
  157.    pfe0601.zip       The 16-bit edition for Windows 3.1x
  158.    pfe0601i.zip      The 32-bit edition for Windows 95 and Windows NT
  159.                        on Intel platforms
  160.    pfe0601p.zip      The 32-bit edition for Windows NT on PowerPC
  161.                        platforms
  162.  
  163. [Note that the characters after 'pfe' are digits zero-six-zero-one]
  164.  
  165. I post PFE to three main archive sites:
  166.  
  167. - For the UK Higher Education sector, it's available in the HENSA/micros
  168.   archive on the micros.hensa.ac.uk system; use Internet ftp, Gopher or
  169.   WWW to find it
  170.  
  171. - On the Internet, I place copies on two archives:
  172.  
  173.      oak.oakland.edu (SimTel)
  174.      ftp.cica.indiana.edu
  175.  
  176. On Usenet, I post an announcement of each release to the
  177. comp.os.ms-windows.announce, comp.os.ms-windows.utilities and comp.editors
  178. groups, and send the distribution set to the moderator of the comp.binaries.ms-windows
  179. group for posting.
  180.  
  181. Though I do not place it there myself, copies should be available from
  182. CompuServe in the WINSHARE forum within a few days of each release. The
  183. filenames there will be
  184.  
  185.    pfe61.zip       The 16-bit edition for Windows 3.1x
  186.    pfe61i.zip      The 32-bit edition for Windows 95 and Windows NT
  187.                       on Intel platforms
  188.    pfe61p.zip      The 32-bit edition for Windows NT on PowerPC
  189.                       platforms
  190.  
  191. If you have a favourite BBS or archive that does not yet have a copy, I would
  192. very much appreciate your posting a copy there too.
  193.  
  194.  
  195.  
  196. 5. UPGRADING FROM 0.05.007 AND EARLIER
  197. --------------------------------------
  198.  
  199. The release of PFE prior to this one was 0.05.007. If you are using this,
  200. you'll find that your keymap (.key) files and template (.tpl) files will
  201. continue to work. Keymap files prodiced with earlier releases than 0.05.007
  202. won't be recognised.
  203.  
  204. However, there have been many changes to the initialisation file (pfe.ini or
  205. pfe32.ini depending on the edition you use).
  206.  
  207. The first major change is that you no longer ever need to edit it to change
  208. options. Now there's an Options Preferences command that does it all - and
  209. you'll find that there are lots more options to choose from too.
  210.  
  211. The second major change involves the filters you define for the file open
  212. dialogs. Your existing ones will not be recognised, so please use Options
  213. Preferences to redefine them.
  214.  
  215. Thirdly, the way the various Windows "managers" (like File Manager and
  216. Print Manager) are handled from the Execute menu has changed, allowing you
  217. to start a full command line with arguments. Your existing definitions will
  218. not be used; again, please use Options Preferences to set up what you want.
  219.  
  220. Finally, the system of associating file and window modes with file extensions
  221. has been completely redesigned. The modes you can set now include window and
  222. text colours; and instead of mapping a single extension to a set of modes, you
  223. now build "mode groups" containing wildcarded filename patterns, each of which
  224. has a set of modes associated with it. Again your old mode settings won't be
  225. recognised, so you'll need to use Options Preferences to use the new system.
  226.  
  227. If you wish, you can remove the [fileopen-filters], [modes] and [managers]
  228. sections from your initialisation file.
  229.  
  230. One other change to note is that the default extension used for making backup
  231. files has changed from ".&&&" to ".$$$". You can also customise it with the
  232. Options Preferences command
  233.  
  234.  
  235.  
  236. 6. OTHER FILES YOU SHOULD LOOK AT
  237. ---------------------------------
  238.  
  239. The distribution set contains several other text files of important
  240. information.
  241.  
  242. For the answers to some of the common questions that users have, see FAQ.TXT.
  243. Looking in here can save you a lot of worry and experimentation, and save you
  244. from posting your question to newsgroups and mailing lists.
  245.  
  246. The CHANGES.TXT file tells you what's changed from earlier releases. If you
  247. find something unexpected going on, look in here too - it could be a feature
  248. rather than a bug.
  249.  
  250. The PROBLEMS.TXT file tells you about any major problems that were discovered
  251. too late to be addressed in this release, and what you can do if you hit them.
  252.  
  253.  
  254. 7. THE FILES YOU SHOULD GET
  255. ---------------------------
  256.  
  257. There are a small number of files in the PFE distribution. You should find the
  258. following items:
  259.  
  260. 16-bit Edition:
  261.  
  262.     pfe.exe            The editor itself
  263.     pfe.hlp            The help file
  264.     $pfedos.exe        A helper module, needed to run commands and
  265.                 capture output
  266.     $pfedos.pif        The PIF file for this module
  267.     readme.txt        This file
  268.     changes.txt        Changes from previous releases
  269.     faq.txt            Frequently Asked Questions
  270.     problems.txt        Information on late-breaking problems
  271.  
  272. 32-bit Edition (Intel):
  273.  
  274.     pfe32.exe        The editor itself
  275.     pfe32.dbg        Debugging symbols
  276.     pfe.hlp            The help file
  277.     $pfeds32.exe        A helper module, needed to run commands and
  278.                 capture output
  279.     readme.txt        This file
  280.     changes.txt        Changes from previous releases
  281.     faq.txt            Frequently Asked Questions
  282.     problems.txt        Information on late-breaking problems
  283.  
  284. 32-bit Edition (PowerPC):
  285.  
  286.     pfe32.exe        The editor itself
  287.     pfe.hlp            The help file
  288.     $pfeds32.exe        A helper module, needed to run commands and
  289.                 capture output
  290.     readme.txt        This file
  291.     changes.txt        Changes from previous releases
  292.     faq.txt            Frequently Asked Questions
  293.     problems.txt        Information on late-breaking problems
  294.  
  295. The help file pfe.hlp is identical for the 16-bit and 32-bit editions.
  296.  
  297.  
  298.  
  299. 8. INSTALLING PFE
  300. -----------------
  301.  
  302. There is no setup program for PFE, as it doesn't really need one. Installation
  303. is done by simply copying the supplied files:
  304.  
  305. 16-bit Edition:
  306.  
  307.  Copy pfe.exe, pfe.hlp, $pfedos.exe and $pfedos.pif to a suitable directory.
  308.  This need not be on your path; but it's important that all the files are
  309.  in the _same_ directory
  310.  
  311. 32-bit Edition:
  312.  
  313.  Copy pfe32.exe, pfe.hlp, $pfeds32.exe to a suitable directory. This need not
  314.  be on your path; but it's important that all the files are in the _same_
  315.  directory. If you have the Intel version you might like to copy pfe32.dbg into
  316.  this directory also; in the event of a program fault your Dr Watson logs will
  317.  contain a symbolic trace, which will make problem diagnosis easier if you're
  318.  able to mail the details to me.
  319.  
  320.  
  321. It's a good idea to keep the 16-bit and 32-bit editions in the same place; then
  322. you will need only one copy of the help file.
  323.  
  324. After you've installed PFE, the best thing to do is start it up, then use the
  325. Options Preferences command to explore the customisation options and set it up
  326. to run as you prefer.
  327.  
  328.  
  329.  
  330. 9. WHICH VERSION SHOULD YOU USE?
  331. --------------------------------
  332.  
  333. The Windows, Windows NT and Windows 95 operating systems allow you a lot of
  334. flexibility in what versions of programs you can run. The pros and cons of
  335. the various combinations are these:
  336.  
  337.  
  338. System        Edition        Comments
  339. ------        -------        --------
  340.  
  341. Windows 3.1x    16-bit        RECOMMENDED. All facilities will be available,
  342.                 and this combination is tested in development
  343.         32-bit Intel    Will run if you have Win32s 1.20. You will not
  344.                 be able to run commands and capture output, and
  345.                 you may find the program crashes when you try
  346.                 to setup your printer. 3D dialog effects are
  347.                 not available. This combination is not tested in
  348.                 development
  349.  
  350. Windows NT 3.1    32-bit Intel    Will not run
  351. (Intel)        16-bit Intel    Will run (see Windows NT 3.5) but you should
  352.                 really upgrade to Windows NT 3.5
  353.  
  354. Windows NT 3.5    32-bit Intel    RECOMMENDED. All facilities will be available,
  355. (Intel)                and this combination is tested in development
  356.         16-bit        Will run, but you will not be able to run
  357.                 commands and capture output. This combination
  358.                 is not tested in development
  359.  
  360. Windows NT 3.5    32-bit PowerPC    RECOMMENDED. This is the only version that will
  361. (PowerPC)            run in this environment; there is no choice. This
  362.                 combination is not tested in development.
  363.  
  364. Windows 95    32-bit Intel    RECOMMENDED. All facilities are available, but
  365.                 at this release integration with the Windows 95
  366.                 look and feel is not complete. This combination
  367.                 is tested in development on Beta M7
  368.         16-bit Intel    Should run, but you will not be able to run
  369.                 commands and capture output. This combination
  370.                 is not tested in development
  371.  
  372.  
  373.